最適化の推奨事項に関するREST APIの使用

最適化の推奨事項に関するHP vPV REST APIは、仮想化インフラストラクチャのデータセンター、クラスター、およびホスト内のVMとデータストアに関するサイズ情報を示します。

リソースモデル

最適化の推奨事項に関するREST APIは、2つのレベルで呼び出すことができます。

エンティティの集合

このレベルでは、仮想化インフラストラクチャのデータセンター、クラスター、ホスト、およびデータストアの集合に関する情報を表示できます。
特定のエンティティ

このレベルでは、データセンター、クラスター、ホスト、データストア、およびVMの特定のインスタンスに関する情報を表示できます。特定のデータセンター、クラスター、およびホストインスタンスのみのVMサイズ情報とデータストアサイズ情報を表示できます。

注:ツリーマップのVM数とREST APIによって返されるVM数が異なる場合があります。これは、REST APIでは仮想化インフラストラクチャのVMのみが考慮されるのに対して、ツリーマップにはVMテンプレートも含まれるためです。

リソース情報

応答形式

JSON

リクエストヘッダー要件

Content-Type: application/json

Authorization:Basic <Base 64でエンコードされたユーザー名:パスワード> (オプション。LDAPが有効になっている場合にのみ必須)

サポートされるリクエストメソッド

GET

リソースURL

エンティティに関する情報を取得するためのベースURLは次のとおりです。

https://<IPアドレスまたはホスト名>:<ポート番号>/PV/api/v1

この例では、

<IPアドレス> または <ホスト名> はHP vPVサーバーのIPアドレスまたはホスト名です。
<ポート番号> はHP vPVサーバーのポート番号です。デフォルトのポート番号は8444です。

ベースURLには、HP vPVサーバーで監視しているさまざまなエンティティに関する情報を取得するための適切なURIを追加する必要があります。次の表に、さまざまなエンティティに応じたREST APIのURLの詳細を示します。

具体的な例を表示するには、URLをクリックしてください。

エンティティ	API	URL
VM	すべてのVMの情報とサイズの詳細を取得するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/vm`
VM	特定のVMの情報を取得するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/vm/<インスタンスID>` この例では、 `<インスタンスID>` はVMのリソースIDです。
データストア	データストアの情報とサイズの詳細を取得するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/datastore`
	特定のデータストアの情報を取得するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/datastore/<インスタンスID>` この例では、 `<インスタンスID>` はデータストアのリソースIDです。
	特定のデータストアのすべてのVMに関する情報を取得するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/datastore/<インスタンスID>/vm` この例では、 `<インスタンスID>` はデータストアのリソースIDです。
	ステータスに基づいてフィルタリングされたデータストア内の特定のVMの情報を取得するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/datastore/<インスタンスID>/vm?status=<VMのステータス>` この例では、 `<インスタンスID>` はデータストアのリソースIDです。 `<ステータス>` はVMの現在のステータスです。パラメーター`status`には、`idle`、`mostlypoweredoff`、`deleted`または`active`の値を指定できます。
クラスター	すべてのクラスターの情報を取得するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/cluster`
	特定のクラスターの情報を取得するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/cluster/<インスタンスID>` この例では、 `<インスタンスID>` はクラスターのリソースIDです。
	特定のクラスター内のすべてのVMのサイズ情報を取得するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/cluster/<インスタンスID>/vmsizing` この例では、 `<インスタンスID>` はクラスターのリソースIDです。
	名前とサイズのパラメーターに基づいてフィルタリングされたクラスター内の特定のVMのサイズ情報を取得するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/cluster/<インスタンスID>/vmsizing?name=<システム名>&sizing=<サイズ>` この例では、 `<インスタンスID>` はクラスターのリソースIDです。 `<システム名>` はVMの表示名です。VMの表示名のサブ文字列を指定できます。 `<サイズ>` は特定のVMのCPUまたはメモリサイズです。パラメーター`sizing`には、`oversized`、`undersized`または`rightsized`の値を指定できます。
	特定のクラスターに属するすべてのデータストアのサイズ情報を取得するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/cluster/<インスタンスID>/datastoresizing` この例では、 `<インスタンスID>` はクラスターのリソースIDです。
データセンター	すべてのデータセンターの情報を取得するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/datacenter`
	特定のデータセンターの情報を取得するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/datacenter/<インスタンスID>` この例では、 `<インスタンスID>` はデータセンターのリソースIDです。
	特定のデータセンターに属するすべてのVMのサイズ情報を取得するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/datacenter/<インスタンスID>/vmsizing` この例では、 `<インスタンスID>` はデータセンターのリソースIDです。
	名前とサイズのパラメーターに基づいてフィルタリングされたデータセンター内の特定のVMのサイズ情報を取得するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/datacenter/<インスタンスID>/vmsizing?name=<システム名>&sizing=<サイズ>` この例では、 `<インスタンスID>` はデータセンターのリソースIDです。 `<システム名>` はVMの表示名です。VMの表示名のサブ文字列を指定できます。 `<サイズ>` は特定のVMのCPUまたはメモリサイズです。パラメーター`sizing`には、`oversized`、`undersized`または`rightsized`の値を指定できます。
	特定のデータセンターに属するすべてのデータストアのサイズ情報を取得するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/datacenter/<インスタンスID>/datastoresizing` この例では、 `<インスタンスID>` はデータセンターのリソースIDです。
ホスト	すべてのホストの情報を取得するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/host`
	特定のホストの情報を取得するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/host/<インスタンスID>` この例では、 `<インスタンスID>` はホストのリソースIDです。
	特定のホスト内のすべてのVMのサイズ情報を取得するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/host/<インスタンスID>/vmsizing` この例では、 `<インスタンスID>` はホストのリソースIDです。
	名前とサイズのパラメーターに基づいてフィルタリングされたホスト内の特定のVMのサイズ情報を取得するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/host/<インスタンスID>/vmsizing?name=<システム名>&sizing=<サイズ>` この例では、 `<インスタンスID>` はホストのリソースIDです。 `<システム名>` はVMの表示名です。VMの表示名のサブ文字列を指定できます。 `<サイズ>` は特定のVMのCPUまたはメモリサイズです。パラメーター`sizing`には、`oversized`、`undersized`または`rightsized`の値を指定できます。
	特定のホスト内のすべてのデータストアの情報とサイズの詳細を取得するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/host/<インスタンスID>/datastoresizing` この例では、 `<インスタンスID>` はホストのリソースIDです。